home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / c / mc302emb.zip / EMCF.DOC < prev    next >
Text File  |  1994-03-18  |  27KB  |  632 lines
  1.         
  2.         
  3.         
  4.         
  5.         
  6.         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.         ================================================================
  14.         EEEEEEE  MM   MM  IIIIIII  L       Y     Y         CCCC   FFFFFF 
  15.         E        M M M M     I     L        Y   Y         C    C  F
  16.         E        M  M  M     I     L         Y Y          C       F
  17.         EEEE     M     M     I     L          Y     ---   C       FFFF
  18.         E        M     M     I     L          Y           C       F
  19.         E        M     M     I     L          Y           C    C  F
  20.         EEEEEEE  M     M  IIIIIII  LLLLLLL    Y            CCCC   F
  21.         ================================================================
  22.     
  23.     
  24.     
  25.     
  26.     
  27.                                        A
  28.                                PC Based Simulator
  29.                                     for the
  30.                             C-FLEA Virtual Processor
  31.     
  32.     
  33.     
  34.     
  35.     
  36.                                   Release 1.0
  37.     
  38.                                Revised 09-Feb-94
  39.     
  40.     
  41.     
  42.     
  43.     
  44.     
  45.     
  46.     
  47.     
  48.     
  49.     
  50.     
  51.     
  52.     
  53.     
  54.                        Copyright 1991-1994 Dave Dunfield
  55.                               All rights reserved
  56.     EMILY-CF: A PC based C-FLEA simulator                            Page: 1
  57.  
  58.  
  59.     1. INTRODUCTION
  60.     
  61.           EMILY-CF is a software simulator for the C-FLEA Virtual Processor.
  62.        It provides a powerful debugging environment, offering many features:
  63.     
  64.        - Supports full 64K of MEMORY. Any portion of memory can be used  for
  65.          CODE or DATA.
  66.     
  67.        - Hardware emulation mode communciates  with  a  target  system,  and
  68.          allows you to include the physical I/O lines, timers etc.  in  your
  69.          simulation.
  70.     
  71.        - Single step, Multi Step, Animate and Full Speed execution modes.
  72.     
  73.        - Simultanious on-screen displays of program disassembly, memory  CPU
  74.          registers and simulation messages.
  75.     
  76.        - Full screen editors for CPU registers, I/O registers, a two  memory
  77.          editors (CODE and DATA). All of the above may be viewed/altered  at
  78.          any time during the debugging session.
  79.     
  80.        - Multiple breakpoints are transparent to the user program.
  81.     
  82.     
  83.        1.1 System Requirements
  84.     
  85.              EMILY-CF will run on any IBM PC/AT/PS2 compatible system with a
  86.           MDA/CGA/EGA or VGA display, and at least 128K of free system RAM.
  87.     
  88.           - If physical serial I/O is used, a  COMM  port  is  required.  If
  89.             hardware emulation is also used, TWO COMM ports are required.
  90.     
  91.           - Some CGA displays may exibit "snow" or flicker during high speed
  92.             screen updates. This effect will not occur with MDA, EGA or  VGA
  93.             displays.
  94.     EMILY-CF: A PC based C-FLEA simulator                            Page: 2
  95.  
  96.  
  97.     2. STARTING UP EMILY-CF
  98.     
  99.           If you are using the optional hardware emulation mode, insure that
  100.        the resident control software (supplied) is inserted into the  target
  101.        system, and that the PC running EMILY-CF is connected to  the  target
  102.        systems serial port  via  COM2.  Power  on  the  test  system  before
  103.        starting EMILY. The resident control software  must  be  active  when
  104.        EMILY "looks" for it.
  105.     
  106.           EMILY-CF is invoked by typing EMCF at the DOS  command  line.  You
  107.        will be greeted with a "welcome" screen which displays a reminder  of
  108.        the command line syntax and the copyright message. This  screen  will
  109.        remain on the display for about 5 seconds (10  seconds  in  the  DEMO
  110.        versin). Pressing any key while this screen is  visible  will  bypass
  111.        this delay, and proceed directly to the main control panel.
  112.     
  113.           If EMILY-CF is given a file name on the command line, she loads it
  114.        in the same manner as if the 'L'oad command had been used from within
  115.        the main control panel.
  116.     EMILY-CF: A PC based C-FLEA simulator                            Page: 3
  117.  
  118.  
  119.           EMILY-CF also accepts several option switches on the command line:
  120.     
  121.             /Hardware[:n] - Enables the hardware emulation feature to cause
  122.                             EMILY to interact with the target  system  when
  123.                             performing I/O accesses.  This  option  may  be
  124.                             followed by a  ':'  and  a  numeric value which
  125.                             defines the BAUD RATE to be used to communicate
  126.                             with the target system. Default is 9600.
  127.     
  128.             /Mono *       - Inhibits the  color display, even  if  a  color
  129.                             adapter is present. This option may  be  useful
  130.                             if your monitor/adapter combination provides an
  131.                             unpleasent or unusable display for EMILY.
  132.     
  133.             /Ports:n      - Specify number of parallel I/O ports to provide
  134.                             on the simulated processor.   If not specified,
  135.                             a default of 4 ports are provided.
  136.     
  137.             /Swapcom      - Exchanges the operation of the two serial ports
  138.                             on the PC.  When this option is used, COM2 will
  139.                             be used for serial I/O redirection.
  140.     
  141.         * Note: If some of the EMILY windows appear  to  be  an  un-readable
  142.                 washed-out yellow color, try adjusting the color contrast on
  143.                 your monitor. Those windows should be an easy to read brown.
  144.     EMILY-CF: A PC based C-FLEA simulator                            Page: 4
  145.  
  146.  
  147.     3. USING EMILY-CF
  148.     
  149.        3.1 The Main Control Panel
  150.     
  151.              Once EMILY-CF is up and running, you will be presented with the
  152.           "Main Control Panel", which consists of four "windows" displaying:
  153.     
  154.             - A disassembly of program memory       (Upper LEFT)
  155.             - The contents of CPU registers         (Upper CENTER)
  156.             - The contents of MEMORY                (Upper RIGHT)
  157.             - Informational messages from EMILY     (Lower portion)
  158.     
  159.              All of EMILY'S functions are  accessed  by  command  characters
  160.           entered from this screen:
  161.     
  162.           3.1.1 A - Animate execution
  163.     
  164.                 This function begins execution of the user program (from the
  165.              address in the PC register). As each instruction  is  executed,
  166.              EMILY will display the  instruction  being  executed,  the  CPU
  167.              registers, and the contents of internal RAM in the  appropriate
  168.              windows.
  169.     
  170.                 When you enter the 'A' command, EMILY will  prompt  you  for
  171.              the number of instructions to animate. Pressing return (without
  172.              entering  a  number)  will  cause  the  animation  to   proceed
  173.              non-stop. Pressing <escape> will return you to the Main Control
  174.              Panel.
  175.     
  176.              The animation will terminate when:
  177.     
  178.                 - The requested number of instructions have been stepped.
  179.                 - A breakpoint is encountered.
  180.                 - An illegal opcode is encountered.
  181.                 - The <escape> key is pressed on the PC console.
  182.     
  183.           3.1.2 B - set Breakpoint
  184.     
  185.                 This command sets a breakpoint such that  program  execution
  186.              under the 'A'nimate, or  'G'o,  commands  will  stop  when  the
  187.              breakpoint address is encountered.
  188.     
  189.                 Up to 10 breakpoints may be in effect at the same time.
  190.     
  191.                 You will be prompted for  the  address  (in  HEX).  Pressing
  192.              return (without entering an address) will cause the  breakpoint
  193.              to be  set  at  the  current  program  counter  (PC)  location.
  194.              Pressing <escape> will return you to the main control panel.
  195.     
  196.                 EMILY stores the breakpoint addresses internally in a simp